feat: 체류상태 긴급 확인과 근로자 안전 보관 UX 구현 - #355

왜 필요한가요?

기록상 체류 만료일이 지난 근로자를 곧바로 불법체류·퇴사로 단정하지 않고, HR이 신청·승인·고용 종료 상태와 근거를 확인해야 합니다. 고용 종료 후에도 과거 업무 이력은 삭제하지 않고 Server의 안전조건을 통과한 경우에만 운영 목록에서 보관합니다.

• feat(knowledge): 체류기간 만료 경과 예외 Workflow 계약 추가 knowledge#54 병합 완료
• 체류기간 만료 경과 긴급 확인 흐름 구현 server#198 병합 완료
• feat: 퇴사 근로자 안전 보관과 업무 차단 구현 server#199 병합 완료
• Closes [feedback] 체류상태 긴급 확인 UX 구현 #346

무엇이 바뀌나요?

• D+N 체류만료를 기록상 D+N 경과 · 긴급 확인으로 변경
• 근로자 상세에 체류상태 확인 시작 추가
• HR 상태 선택 5종과 다음 행동 미리보기 구현
• 승인 완료·심사 중에는 등록된 증빙 서류 선택을 필수화
• 증빙이 없으면 기존 서류 등록 화면으로 이동
• 승인된 새 만료일, 신청일, 재확인일, 공식 확인 메모 입력
• 고용 종료 확인 전에는 안전 보관 UI를 노출하지 않음
• 고용 종료 확인 후 Server의 차단 사유를 사람이 이해할 문구로 표시
• 안전조건을 모두 통과한 근로자만 보관 사유와 expected_version으로 보관
• 법적 체류 상태·퇴사 여부를 자동 확정하지 않는 안내 추가
• 저장 직후 부모 화면 갱신으로 모달 결과가 사라지던 문제를 수정하고, 사용자가 모달을 닫을 때만 상세 화면을 갱신

API 계약

• POST /api/v1/stay-verifications/scan
• GET /api/v1/stay-verifications
• PATCH /api/v1/stay-verifications/{id}
• GET /api/v1/workers/{workerId}/archive-eligibility
• POST /api/v1/workers/{workerId}/archive

검증

• bun run test — 84 files, 472 tests
• bun run build
• bun run lint — 오류 0, 기존 routes.tsx 경고 13건
• 만료 경과 표현 회귀 테스트
• 증빙 없는 승인 완료 차단 테스트
• 고용 종료 확인 전 안전 보관 미노출 테스트
• 고용 종료 후 Server 차단 사유 표시 테스트
• Server 최신 main과 Client 브랜치를 로컬에서 실제 연결
• 로그인 → 만료 경과 근로자 상세 → HR 확인 저장 → 안전 보관 차단 사유 조회 확인
• 저장 후 성공 안내와 차단 사유가 모달에 유지되는지 확인

병합 전 확인

선행 Knowledge·Server 변경은 모두 병합되었습니다. 다만 실제 Client 화면 연결 결과를 사용자와 함께 확인하기 전까지 Draft로 유지하며, 이 PR은 자동으로 병합하지 않습니다.